NewPixPat

Create an empty pixPat data structure; obtain a pixPat

handle

#include <Quickdraw.h> Color Quickdraw

NewPixPat allocates storage for a pixPat data structure and a pixPatHandle,

calls NewPixMap to set and store the pixel pattern's pixMap, copies the

current device's pixMap fields, setting the type of the pixPat as a color

pattern.

Returns: a PixPatHandle which leads to a pixPat data structure.

Notes: NewPixPat initializes the pat1Data field to 50% gray. Altogether,

NewPixPat allocates six handles, including handles that are set up but

not initialized for data, expanded data, expanded map, color tables, and

itself.

The pixMapHandle and the pixPatHandle are both the size of their own data

structures. The size of the expanded data handle grows with the size of the

pattern data but is adjusted according to screen depth. The color table

handle is the size of the record structure plus 8*n where n equals the total

colors in the table.

Since the GetPixPat routine can easily read in a pattern from a resource

file, it's unlikely you'll need NewPixPat very often.

Referenced by (3):